home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1993 November / JCSM Shareware Collection - 1993-11.iso / cl240 / byteditj.lzh / BE.DOC next >
Encoding:
Text File  |  1993-02-09  |  10.6 KB  |  310 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                Byte Editor 1.2
  24.  
  25.                           by Bradford B. Taliaferro
  26.  
  27.                            S E M P R I N I W A R E
  28.  
  29.             SoftWare that doesn't garble strange radio transmissions
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39. Introduction:  The Byte Editor is an attempt to bring the ease of word 
  40.                processing to those of us who occasionally hack byte by byte
  41.                into our code.  It also is the beginning of an assembler-oriented
  42.                byte editor.
  43.  
  44.  
  45.  
  46. Screen:        The top of the screen displays the current date and time.  The
  47.                second line displays the file's time and date of creation, the
  48.                file's attributes, and the file name.  You can change the file
  49.                creation date and time (see F8).
  50.  
  51.                The main screen in Byte Editor is very simple.  There are two
  52.                main areas - the Hexidecimal listing and the Ascii listing.  If
  53.                an undisplayable character is in the file, it will be displayed
  54.                as an upside down question mark.  The hexidecimal listing is
  55.                a 16 X 16 display of the values of the bytes in one block of 
  56.                your file.  The ascii display is a 16 X 16 display of the 
  57.                characters in one block of your file.
  58.  
  59.                Move the cursor around with the cursor keys.  Notice that the
  60.                index highlite (which tells you the row and column of the 
  61.                cursor) changes to enable you to quickly locate the byte of 
  62.                interest.  The index will be highlited on both the ascii
  63.                display and the hex display.
  64.  
  65.                After the hex and ascii sections are the binary, octal, decimal
  66.                and assembler sections.  These are smaller display and only
  67.                display the value of the current byte.  You can change the 
  68.                active area using CTRL-H,T,B,O,D,A (see key usage).
  69.  
  70.                When an area is active you can edit the current byte in that
  71.                numbering system or language.  An area is active if the 
  72.                highlite is displayed in yellow on red (white on grey for 
  73.                monochrome).  For instance, if the binary section is highlited,
  74.                you could type in a binary byte.  You can determine what area
  75.                is active in two ways; The active highlite is read; or look at 
  76.                the area indicator (between the hex and ascii sections).
  77.  
  78.  
  79.                There are indicators between the hex and ascii areas. The first
  80.                is the area indicator.  It indicates which area is currently
  81.                active.  The second is an indication of byte offset from 
  82.                beginning of file.  The third is the current block number and
  83.                the total number of blocks (a block is 256 bytes).
  84.  
  85.  
  86.  
  87.  
  88. Usage:         BE fname [/N] [/M]
  89.  
  90.                fname = the file you wish to edit.
  91.  
  92.                /N    = No direct screen writes
  93.  
  94.                /M    = Monochrome screen
  95.  
  96.                /VER  = displays program name, release date and
  97.                        other useful information.
  98. KEYS:
  99.  
  100.  
  101.                F1 = Help Screen.  Displays the active keys and
  102.                     their functions.
  103.  
  104.  
  105.    ASCII SEARCH
  106.  
  107.                F2 = Ascii Search.  Searchs for Ascii (or text) in
  108.                     the file.  You will prompted for the ascii string
  109.                     to search for.  Type it in and press enter.
  110.                     either the file will be advanced to the first 
  111.                     occurence of the string or you will see a message
  112.                     "search string xxxx not found."
  113.  
  114.                SHIFT-F2 = Just like F2 but with replace and query 
  115.                           option.  After typing in the search string
  116.                           you will be queried for the replacement 
  117.                           string.  If the search string is found you
  118.                           will then be asked if you wish to replace
  119.                           the search string with the replacement 
  120.                           string.  Press Y for Yes and N for No.
  121.  
  122.                ALT-F2 = Just like SHIFT-F2 but without the query
  123.                         for replacement.  It will search for the
  124.                         string and replace it if found.
  125.  
  126.                CTRL-F2 = Repeat the last ascii search.
  127.  
  128.  
  129.  
  130.    HEX SEARCH
  131.  
  132.                F3 = Hex Search.  Searchs for a hex string in
  133.                     the file.  You will prompted for the hex string
  134.                     to search for.  Type it in and press enter.
  135.                     either the file will be advanced to the first 
  136.                     occurence of the string or you will see a message
  137.                     "search string xxxx not found."
  138.  
  139.                SHIFT-F3 = Just like F3 but with replace and query 
  140.                           option.  After typing in the search string
  141.                           you will be queried for the replacement 
  142.                           string.  If the search string is found you
  143.                           will then be asked if you wish to replace
  144.                           the search string with the replacement 
  145.                           string.  Press Y for Yes and N for No.
  146.  
  147.                ALT-F3 = Just like SHIFT-F3 but without the query
  148.                         for replacement.  It will search for the
  149.                         string and replace it if found.
  150.  
  151.                CTRL-F3 = Repeat the last hex search.
  152.  
  153.  
  154.  
  155.  
  156.    ASSEMBLER SEARCH
  157.  
  158.                F4 = Assembler Search.  Searchs for ASM code in
  159.                     the file.  You will prompted for the ASM string
  160.                     to search for.  Type it in and press enter.
  161.                     either the file will be advanced to the first 
  162.                     occurence of the string or you will see a message
  163.                     "search string xxxx not found."
  164.  
  165.                CTRL-F4 = Repeat the last ASM search.
  166.  
  167.  
  168.                NOTE:  The assembler portions of this program are 
  169.                still in the development stage.  Any 
  170.                suggestions are welcome to help finish up this
  171.                stage of the program.  When my assembler 
  172.                knowledge is up to speed this portion of
  173.                the program will be too.
  174.  
  175.  
  176.  
  177.  
  178.    GOTO
  179.  
  180.              F5 = Goto block (decimal).  You will be queried for 
  181.                   the block to jump to.
  182.  
  183.              ALT F5 = Goto block (hexidecimal).  You will be 
  184.                       queried for the block to jump to.
  185.  
  186.  
  187.    FILE I/O
  188.  
  189.              F6 = Save current block to disk.
  190.  
  191.              F7 = Reread block from disk.
  192.  
  193.  
  194.  
  195.    FILE ATTRIBUTES
  196.  
  197.            F8 = Change the file's creation time.
  198.  
  199.            ALT F8 = Change the file's creation date.
  200.  
  201.  
  202.    OTHER KEYS
  203.  
  204.            F10 = Exit program.
  205.  
  206.            PAGE UP = Move up one block (decrement block number).
  207.  
  208.            CTRL-PAGE UP = Move up ten blocks (decrement block
  209.                           number by ten).
  210.  
  211.            PAGE DOWN = Move down one block (increment block 
  212.                        number).
  213.  
  214.            CTRL-PAGE DOWN = Move down ten blocks (increment block
  215.                             number by ten).
  216.  
  217.            HOME = Go to byte 0 in the current block.
  218.  
  219.            CTRL-HOME = Go to top of file.
  220.  
  221.            END = Go to byte 255 in the current block.
  222.  
  223.            CTRL-END = Go to end of file.
  224.  
  225.            TAB = switch active area (hex, dec, oct, ascii, etc.).
  226.  
  227.            CTRL-A = Make Assembler area active.
  228.            CTRL-B = Make Binary area active.
  229.            CTRL-D = Make Decimal area active.
  230.            CTRL-H = Make Hex area active.
  231.            CTRL-O = Make Octal area active.
  232.            CTRL-T = Make Text(ascii) area active.
  233.  
  234.  
  235.  
  236.  
  237. NOTES:
  238.  
  239.            1.  The assembler portions of this little system are not yet
  240.            finished.  Having just moved, it is hard to find time to complete
  241.            such a time consuming part.  The rest of it is in constant use by
  242.            SempriniWare and other small companies.  Let me know if you have
  243.            any suggestions on its completion.
  244.  
  245.            2.  If you are comparing DOS debug to BE, remember that BE does not
  246.            add anything to the byte location.  The address you see is the actual
  247.            offset from the beginning of the file.  If you find a byte at location
  248.            XXXX:0110 in debug you will find it at 0010 in BE.
  249.  
  250.  
  251. UPDATES: 
  252.  
  253.            Version 1.1 - fixed a positively hideous error that caused the editor
  254.            to display the incorrect block on a failed search.  Yeesh!  Also, I 
  255.            am taking advantage of Mike Durkin's fine CRC check program and his 
  256.            generous Shareware allowances.  If I make any - you'll get yours, 
  257.            Mike!  Added the /ver option which is to be standard for all 
  258.            SempriniWare.
  259.  
  260.            Version 1.2 - minor enhancements in preparation for submission to
  261.            PS-SIG.
  262.  
  263.  
  264.  
  265.  
  266.                REGISTRATION FORM - Byte Editor - FEE [$15]
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275. NAME ___________________________     PHONE (Optional)__________________
  276.  
  277. ADDRESS_________________________     CITY, STATE_______________________
  278.  
  279. ZIP_____________________________     OCCUPATION________________________
  280.  
  281. COMPUTER USE (programs, games, etc, i.e. 'what do you do?')____________
  282. _______________________________________________________________________
  283. _______________________________________________________________________
  284. _______________________________________________________________________
  285.                                                                        
  286. COMMENTS_______________________________________________________________
  287. _______________________________________________________________________
  288. _______________________________________________________________________
  289. _______________________________________________________________________
  290. _______________________________________________________________________
  291. _______________________________________________________________________
  292. _______________________________________________________________________
  293. _______________________________________________________________________
  294. _______________________________________________________________________
  295. _______________________________________________________________________
  296.  
  297.  
  298.      Contributions are encouraged and suggestions are invited.  Send all 
  299. correspondence to:
  300.  
  301.                         Bradford B. Taliaferro
  302.                         RR 1 Box 181
  303.                         Rosendale, MO 64483
  304.  
  305.          Or Call our BBS - The Micron Firefly - 816-324-3148
  306.  
  307.  
  308.  
  309.  
  310.